package com.example.domain.strategy.repository;

import com.example.domain.strategy.model.entity.StrategyAwardEntity;
import com.example.domain.strategy.model.entity.StrategyEntity;
import com.example.domain.strategy.model.entity.StrategyRuleEntity;
import com.example.domain.strategy.model.valobj.RuleTreeVO;
import com.example.domain.strategy.model.valobj.StrategyAwardRuleModelVO;
import com.example.domain.strategy.model.valobj.StrategyAwardStockKeyVO;

import java.util.HashMap;
import java.util.List;

/**
 * @Author: 三石
 * @desc: 策略仓储接口
 * @Date: 2024-07-18-22:23
 */
public interface IStrategyRepository {

    /** 查询指定抽奖策略下的奖策奖品集合 */
    List<StrategyAwardEntity> queryStrategyAwardList(Long strategyId);

    /** 存储策略奖品概率查找表到redis中 */
    void storeStrategyAwardSearchRateTable(String key, int rateRangeSize, HashMap<Integer, Long> shuffleStrategyAwardSearchRateTable);

    /** 获取存储抽奖策略范围值 -> 没有权重装配的情况 */
    Integer getRateRange(Long strategyId);

    /** 获取存储抽奖策略范围值 -> 权重装配的情况*/
    Integer getRateRange(String key);

    /** 获取随机奖品ID -> 没有权重装配的情况 */
    Long getStrategyAwardAssemble(Long strategyId, int randomRate);

    /** 获取随机奖品ID -> 权重装配的情况 */
    Long getStrategyAwardAssemble(String key, int randomRate);

    /** 通过策略ID查询策略实体 */
    StrategyEntity queryStrategyEntityByStrategyId(Long strategyId);

    /** 查询指定策略ID和抽奖规则类型的策略规则实体 */
    StrategyRuleEntity queryStrategyRuleEntity(Long strategyId, String ruleModel);

    /** 根据策略ID,奖品ID(可能是null),规则模型查询 规则模型信息 */
    String queryStrategyRuleValue(Long strategyId, Long awardId, String ruleModel);

    /** 重载方法： 根据策略ID,奖品ID(可能是null -> 不传),规则模型查询 规则模型信息 */
    String queryStrategyRuleValue(Long strategyId, String ruleModel);

    /** 查询策略奖品配置的规则模型 */
    StrategyAwardRuleModelVO queryStrategyAwardRuleModelVO(Long strategyId, Long awardId);

    /**
     * 根据规则树ID，查询树结构信息
     *
     * @param treeId 规则树ID
     * @return 树结构信息
     */
    RuleTreeVO queryRuleTreeVOByTreeId(String treeId);

    /**
     * 缓存产品库存
     * @param key key
     * @param awardCount 库存量
     */
    void cacheStrategyAwardCount(String key, Integer awardCount);

    /** 扣减奖品缓存库存 */
    Boolean subtractionAwardStock(String key);

    /** 写入延迟队列，延迟消费更新数据库记录 */
    void awardStockConsumeSendQueue(StrategyAwardStockKeyVO strategyAwardStockKeyVO);

    /** 获取奖品库存消耗队列 */
    StrategyAwardStockKeyVO takeQueueValue();

    /** 更新奖品库存消耗记录 */
    void updateStrategyAwardStock(Long strategyId, Long awardId);

    /**
     * 根据策略ID+奖品ID的唯一值组合，查询奖品信息
     *
     * @param strategyId 策略ID
     * @param awardId    奖品ID
     * @return 奖品信息
     */
    StrategyAwardEntity queryStrategyAwardEntity(Long strategyId, Long awardId);
}
